home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 104 / applic / address.doc next >
Text File  |  1987-02-20  |  8KB  |  192 lines
  1.  
  2.  
  3.  
  4.  
  5.                         STreet finder 1.0
  6.                             Written by
  7.                           John Buchanan
  8.                      Dept of Computer Science
  9.                       University of Toronto
  10.                          Toronto, Ontario
  11.                              M5S 1A4
  12.  
  13.                     This program is shareware
  14.                 If you like it a lot then send me
  15.                             some money
  16.  
  17.  
  18.  
  19.      Introduction
  20.  
  21.      STreet finder is an address book that was developed with  the 
  22. user  interface  in mind.   In fact the  interface  was  completed 
  23. before the program had the ability to handle any  addresses.   The 
  24. idea was to simulate an address book.   Notice that address  books 
  25. are  extremely user friendly.   When was the last time  that  your 
  26. address book told you that you entered a wrong entry into it? 
  27.  
  28.      STreet  finder  incorporates a feature that is not  found  in 
  29. ordinary address books.   If the first character in the name field 
  30. is not the same as the current page then a cross referenced  entry 
  31. can be seen on the appropriate page.
  32.  
  33.      i.e.   If John Buchanan appears in the name field of an entry 
  34. in page B then this entry can be seen on Page J
  35.  
  36.      Pages for particular letters are accessed by either  clicking 
  37. the  mouse in the appropriate chicklet (Rectangle with the  letter 
  38. in it) or by depressing the appropriate key on the keyboard.
  39.  
  40.      When the book is opened there are several things that must be 
  41. noticed.
  42.  
  43. 1)     The  current  page is indicated by  highlighting  the  page 
  44.        chicklet.   Also there is a superscript above the letter in 
  45.        the  highlighted chicklet.  This indicates the page  number        
  46.        for the current letter.  i.e. a letter can have more than 8        
  47.        entries.
  48.  
  49. 2)     On  the right hand side of the new command line  there  are 
  50.        two chicklets with a left arrow and a right arrow in  them.  
  51.        With  these chicklets you can flip through the  book.   The 
  52.        above action can also be accomplished by using the left and 
  53.        right arrows on the key board.
  54.  
  55. 3)     On  the  left hand side of the command line there  are  two 
  56.        commands.
  57.  
  58.        Insert  This inserts a new address blank at the end of  the 
  59.                current page.  (before any cross referenced entries 
  60.                for  this page)  This can also be  accomplished  by 
  61.                using the insert key on the keyboard.
  62.  
  63.        Delete  This places you in delete mode.   The mouse  cursor 
  64.                says  DELETE  in it and you have to  point  at  the 
  65.                address that you want to delete.  If you point at a 
  66.                valid  address an alert box comes up asking you  if 
  67.                you  are sure that you want to delete the  address.  
  68.                If  you point at an invalid address you  will  exit 
  69.                delete  mode.   You  can enter the delete  mode  by 
  70.                using the delete key on the keyboard.
  71.  
  72. 4)     CLOSE.   This  simply closes the book  and  redisplays  the 
  73.                 cover of the box. This can also  be done using the
  74.                 Clr Home key
  75.  
  76.  
  77. 5)    You are wondering how to edit an address field.
  78.  
  79.        In  order to edit point at the address field that you  want 
  80. to edit.  A cursor appears at the end of the line that you pointed 
  81. at  and the mouse cursor now says edit.   ( There is a slight  bug 
  82. here.  If  you point at the line between two entries in a  address 
  83. field the cursor says edit but no editing cursor  appears.  Simply 
  84. point the cross that is now on the mouse cursor at the entry  that 
  85. you want to edit.)  
  86.  
  87.      Because  of  the cross referencing feature you can  edit  all 
  88. entries in a cross referenced address exept the name.  If you want 
  89. to edit the name you must edit the original entry.  (as you change 
  90. the first letter its cross reference will move from page to page.)
  91.  
  92.  
  93. EDIT MODE key interpretation
  94.        
  95.        Left Arrow        Move  edit cursor one  character  to  the 
  96.                          left.
  97.  
  98.        Right Arrow       Move  edit  cursor one character  to  the 
  99.                          right.
  100.  
  101.        Up Arrow          Move to previous entry in address field.
  102.  
  103.        Down Arrow        Move to next entry in the address field.
  104.  
  105.        Shift Left Arrow  Move to the beginning of current entry.
  106.  
  107.        Shift Right Arrow Move to the end of current entry.
  108.  
  109.        Alphabetical/
  110.        Numerical/
  111.        Shifted  Numeric  Insert into the current entry.
  112.  
  113.  
  114. 8)     ending the program or exiting the desk accesory
  115.  
  116.      Clicking  in the upper left close box will cause you to  exit 
  117. the address book.  If you have edited any address then you will be 
  118. asked  wether  you want to save the changes.   If you  say  no  an 
  119. internal flag is set and you will not be prompted again.
  120.  
  121.       Also My disk i/o is not to intelligent so I have not  figured 
  122. out what to do with empty files so if you atempt to save an  empty 
  123. book  I  have made it so that it saves my address.   If  you  have 
  124. another address in the book you can delete my address and be  done 
  125. with me.
  126.  
  127. 8b)  File format
  128.  
  129.      All data is stored in stfind.dat which has to  be on the root 
  130. directory of the a: drive (I will allow this to change later on).
  131. The Data is stored in ascii format.  Not terribly eficient but one 
  132. of  my main beefs against all the other address book  managers  is 
  133. that it is hard to access the data.  
  134.  
  135. each address line fits on one line of the output file.
  136.  
  137. For example John Buchanan
  138.             tel1            tel2
  139.             line1
  140.             line2
  141.             line3             code
  142.           on page B
  143. is stored
  144. B<cr>
  145. John Buchanan<cr>
  146. tel1<cr>
  147. tel2<cr>
  148. line1<>cr> ... and so on. you get the idea
  149.  
  150. 7)     PRINT
  151.        This is something that I've just started playing with.   It 
  152. is only accessible from the program.   I assumed that printing out 
  153. 26+  pages of stuff is not something that you will want to do  all 
  154. the  time.   Right now it just prints out all the pages  that  are 
  155. required.  >=27  One  for the tile page.   What you do  with  this 
  156. output  is to cut all the pages at the dotted line and fold  each 
  157. page  so that the addresses are on the outside of  the  page.  Now 
  158. staple all the pages together in order to form a little  booklet. 
  159. Voilà you have a little address book.   In six months print out an 
  160. updated one.  I do not claim that this part of the program is very 
  161. clean.   (I  have  a Roland 1011) printer which I  think  is  100% 
  162. compatible  with   an Epson LX-80 printer.   In the  next  version  
  163. (May)  I  Hope  to have a better interface to  this  part  of  the 
  164. program.
  165.      
  166.  
  167.      I have developed two versions of the program.   One is a Desk 
  168. accessory and the other is a program.   I read somewhere that a DA 
  169. could not dynamically allocate memory,  this forced me to  develop 
  170. different data structure management schemes.   The DA will only let 
  171. you 10 new addresses per session.  The program allow you to add as 
  172. many as you want in one session.
  173.  
  174.      The  DA runs best if you close the window before you  exit  a 
  175. particular application.
  176.  
  177. I hope that this is useful.   I find it very useful and I have had 
  178. a lot of fun developing it.   I don't think that I'd be willing to 
  179. let the source code float around right now.  I want to retain some 
  180. control  on  this for now.   Maybe even get it to run on  a  color 
  181. monitor   ( Probability ~=0) some day.   
  182.  
  183. I'm  In  the process of finishing my course  requirements  for  my 
  184. masters so don't expect any immediate updates.  
  185.  
  186. Enjoy
  187.  
  188.  
  189. Pardon the hacked up documentation above.   It is midnight after a 
  190. long day.
  191.  
  192.